dominikmodrzejewski99/ngx-signal-datetimepicker

GitHub: dominikmodrzejewski99/ngx-signal-datetimepicker

一个基于Angular Signal Forms的零依赖日期时间选择器,提供WCAG 2.2 AAA合规的跨浏览器一致体验。

Stars: 1 | Forks: 0

# ngx-signal-datetimepicker [![npm](https://img.shields.io/npm/v/ngx-signal-datetimepicker.svg)](https://www.npmjs.com/package/ngx-signal-datetimepicker) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

ngx-signal-datetimepicker demo — open picker, pick a date, pick a time

这是一个 Angular 工作空间,包含: - `projects/ngx-signal-datetimepicker` — 可发布的库 - `projects/demo` — 一个展示所有用法模式的演示应用 ### 为什么不用 ``? 原生输入适用于原型。在实际应用中,你通常需要浏览器无法提供的功能: - **一致的用户体验**,覆盖 iOS(滚轮)、Android(日历)和桌面浏览器 - **应用级区域设置**,而非“取决于用户的操作系统设置” - **模型中的 `Date` 对象**,而非每个边界都需解析的 ISO 字符串 - **样式化/本地化的验证消息**,可通过 Signal Forms 或 Reactive Forms 传递 - **禁用日期/范围**、自定义触发器、内联模式 - **移动端完整键盘支持**(Chrome Android 的 `date` 输入仍缺乏此功能) - **符合 WCAG 2.2 AAA 标准**,不依赖于浏览器 查看完整的功能对比,请参阅 [库的 README](./projects/ngx-signal-datetimepicker/README.md#why-not-input-typedatetime-local)。 📦 **包名:** [`ngx-signal-datetimepicker`](./projects/ngx-signal-datetimepicker/README.md) — 完整 API 文档请见库的 README。 ## 仓库结构 ``` . ├── projects/ │ ├── ngx-signal-datetimepicker/ ← library (published to npm) │ └── demo/ ← demo app (used for local development) ├── angular.json ├── package.json └── LICENSE ← MIT ``` ## 本地开发 ``` npm install # 构建库(必须在运行演示前执行,以确保路径别名正确解析) npm run build:lib # 运行演示 npm start ``` 该库使用 [ng-packagr](https://github.com/ng-packagr/ng-packagr);演示应用通过 `tsconfig.json` 中声明的 TypeScript 路径别名引用它。 ## 发布到 npm ``` # 1. 在 projects/ngx-signal-datetimepicker/package.json 中提升版本号 # 2. 构建全新的 dist npm run build:lib # 3. 干运行以检查将要发布的内容 cd dist/ngx-signal-datetimepicker npm publish --dry-run # 4. 发布(必须先登录 npm:`npm login`) npm publish --access public ``` ## 推送到 GitHub 库的 `package.json` 中建议的仓库名称为 `ngx-signal-datetimepicker`。如果你复刻或重命名,请相应调整其中的 URL。 ``` git init git add . git commit -m "Initial commit" git branch -M main git remote add origin git@github.com:/ngx-signal-datetimepicker.git git push -u origin main ``` ## 贡献 欢迎提交 Issues 和 PRs。该库有意保持精简 — 请保持其无依赖且基于标准。 ## 许可证 MIT
标签:Angular, Date 对象, Grype, npm 包, Signal Forms, TypeScript, UI 控件, WCAG 2.2 AAA, 内联模式, 前端组件, 可访问性, 国际化, 安全插件, 日历, 日期时间选择器, 日期范围禁用, 时间选择, 本地化, 样式化验证, 桌面端支持, 浏览器兼容, 移动端支持, 自动化攻击, 自定义触发器, 表单控件, 键盘支持, 零依赖