@gravity-ui/date-组件

安装
npm install react react-dom @gravity-ui/uikit @gravity-ui/date-components @gravity-ui/date-utils
使用量
import {createRoot} from 'react-dom/client';
import {DatePicker} from '@gravity-ui/date-components';
import {Provider} from '@gravity-ui/uikit';
import '@gravity-ui/uikit/styles/styles.css';
function App() {
return (
<Provider>
<h1>DatePicker</h1>
<form>
<label htmlFor="date-picker">Date: </label>
<DatePicker id="date-picker" name="date" />
</form>
</Provider>
);
}
const root = createRoot(document.getElementById('root'));
root.render(<App />);
本地化
import {settings} from '@gravity-ui/date-utils';
// Load date locales that will be used in an application.
await settings.loadLocale('ru');
function App() {
return (
// Set the language to use with components.
<Provider lang="ru">
<h1>DatePicker</h1>
<form>
<label htmlFor="date-picker">Дата: </label>
<DatePicker id="date-picker" name="date" />
</form>
</Provider>
);
}
如果应用程序支持语言切换,则在应用程序首次加载时预加载所有支持的地块,或在切换语言前加载地块:
// Preload locales
await Promise.all([settings.loadLocale('ru'), settings.loadLocale('nl')]);
const root = createRoot(document.getElementById('root'));
root.render(<App />);
// or load locales on demand.
function App() {
const [lang, setLang] = React.useState('en');
const handleLangChange = (newLang) => {
settings.loadLocale(newLang).then(() => {
setLang(newLang);
});
};
return <Provider lang={lang}>...</Provider>;
}
这些组成部分有英文和俄文翻译。 增加其他语文的翻译,使用 addLanguageKeysets 从 @gravity-ui/uikit数字 :
import {addLanguageKeysets} from '@gravity-ui/uikit/i18n';
import type {Keysets, PartialKeysets} from '@gravity-ui/date-components';
// Use the Keyset type to specify translations for all available components
addLanguageKeysets<Keysets>(lang, {...});
// or use the PartialKeysets type to specify only the ones you need
addLanguageKeysets<PartialKeysets>(lang, {...});
// To specify translations for some components
addLanguageKeysets<Pick<Keysets, 'g-date-calendar' | 'g-date-date-field' | 'g-date-date-picker'>>(lang, {...});
移徙
- 从 4.x 到 5.x (
@gravity-ui/uikitv8) 时间轴: 文件/移民4至5.md
发展
要启动开发服务器, 故事本运行如下 :
npm start
许可证
根据麻省理工学院的许可证分发。 见 自由主义 详细情况.
对于人工智能特工
对Gravity UI 应用软件的反应日期和时间控制——基于日期/时间取取器、日历和绝对/相对范围选择器 @gravity-ui/date-utils。 。 。 .
何时使用
- 单个日期或日期时间输入 :
DatePicker, (中文(简体) ),DateField。 。 。 . - 选定月/日的日历:
Calendar, (中文(简体) ),CalendarView。 。 。 . - 日期范围 :
RangeDatePicker, (中文(简体) ),RangeCalendar, (中文(简体) ),RangeDateField。 。 。 . - 相对和混合的绝对/相对范围(例如“最后7天”):
RelativeDatePicker, (中文(简体) ),RelativeRangeDatePicker, (中文(简体) ),RelativeDateField。 。 。 .
不使用时
- 纯文本或数字输入、按钮或其他通用控件——使用
@gravity-ui/uikit。 。 。 . - 低等日期数学,解析,格式化,或没有UI的时区处理——使用
@gravity-ui/date-utils直接说.
常见陷阱
- 值为
DateTime对象,而不是联署材料Date。 。 。 . 部门与dateTime()从@gravity-ui/date-utils; 通过并读取DateTime,非本地语言Date或 ISO 字符串. - 需要uikit设置. 内部渲染
Provider从@gravity-ui/uikit导入@gravity-ui/uikit/styles/styles.css· ;@gravity-ui/uikit页:1@gravity-ui/date-utils需要同伴依赖关系. - 地产已经装入了, 不只是设定. 通过
Providerlang,但首先加载语言数据settings.loadLocale('ru')从@gravity-ui/date-utils,或者在默认的地块中提供日期. - 具体组成部分的翻译使用
addLanguageKeysets。 。 。 . 外语en编号 :ru,通过addLanguageKeysets从@gravity-ui/uikit/i18n使用Keysets编号 :PartialKeysets类型导出在此 .
AI代理的文件
安装版本的可代理读取文档位于 node_modules/@gravity-ui/date-components/dist/docs/INDEX.md。 。 。 .