@jalali-js/ui-web
v0.4.2
Published
RangePicker, EventCalendar, InlineCalendar, and extra themes for @jalali-js/web, built on the same headless Web Components.
Maintainers
Readme
@jalali-js/ui-web
Higher-level Web Components on @jalali-js/web: range, inline, event, and time-range
pickers, plus extra themes.
Start here: Live demo · Documentation
npm ecosystem: jalali-js · @jalali-js/i18n · @jalali-js/nlp · @jalali-js/holidays · @jalali-js/react · @jalali-js/vue · @jalali-js/web · @jalali-js/ui-react · @jalali-js/ui-vue · @jalali-js/ui-web
Contents
Install
npm install @jalali-js/ui-web @jalali-js/webimport '@jalali-js/web';
import '@jalali-js/ui-web';
import '@jalali-js/web/date-picker.css';Compatibility
| Item | Support |
| -------- | ---------------------------------------------- |
| Runtime | Modern browsers with Custom Elements |
| Peers | None (@jalali-js/web is a normal dependency) |
| Node | 22 and 24 (CI matrix) |
| Verified | Chromium, Firefox, WebKit in e2e |
Quick start
<script type="module">
import '@jalali-js/web';
import '@jalali-js/ui-web';
import '@jalali-js/web/date-picker.css';
</script>
<jalali-range-picker system="jalali" locale="fa"></jalali-range-picker>Elements
| Element | Role |
| ---------------------------- | ------------------------------------ |
| <jalali-range-picker> | Start and end dates |
| <jalali-inline-calendar> | Always-visible month grid |
| <jalali-event-calendar> | Month / week / day / timeline events |
| <jalali-time-range-picker> | Start and end times |
Options
Key <jalali-range-picker> attributes:
| Attribute | Values | Default | Notes |
| --------------- | ---------------------- | --------------- | ---------------- |
| system | jalali / gregorian | jalali | Display calendar |
| locale | en / fa / ps | en | UI language |
| value-format | gregorian-iso / … | gregorian-iso | Storage shape |
| show-holidays | boolean attribute | off | Mark holidays |
EventCalendar: view (month / week / day / timeline), events and
timeline (properties), event-click event. Timeline layout is single,
alternating, or roadmap.
Full tables: Web Components guide.
Theming
[data-jalali-datepicker-root] {
--jalali-primary: #0f766e;
--jalali-radius: 12px;
}See Theming.
Links
License
MIT
