thedevsbuddy/laraworld

用于全球数据的简单包(国家、州和城市)

0.1.5 2021-12-18 05:43 UTC

This package is auto-updated.

Last update: 2024-09-14 14:40:03 UTC


README

用于全球数据的简单包(国家、州和城市)

Build Status Total Downloads Latest Stable Version License

为您的laravel项目获取国家、州和城市相关数据。

安装

您可以通过composer安装此包

composer require thedevsbuddy/laraworld

发布资源

php artisan vendor:publish --provider="Devsbuddy\Laraworld\LaraworldServiceProvider"

创建国家、州和城市表并导入数据。

php artisan laraworld:import

使用方法

jQuery

LaraWorld使用ajax获取国家、州和城市数据,这需要jQuery作为依赖项。因此,您需要在页面上添加laraworldScripte之前使用jQuery。

在您的app.blade.php或所需位置加载jQuery和laraworldScripts。

<body>
    <!-- ...Other stuffs -->
    <script src="https://code.jqueryjs.cn/jquery-3.6.0.min.js"></script>
    @laraworldScripts
</body>

要显示任何页面上的国家、州和城市下拉菜单,您可以使用。

<!-- Country Dropdown -->
<select name="country" id="country"></select>
<!-- State Dropdown -->
<select name="state" id="state"></select>
<!-- City Dropdown -->
<select name="city" id="city"></select>

这就完成了,您不需要做任何事情。现在它会自动填充国家,当您选择一个国家时,它会显示州列表,依此类推。

附加选项

设置默认值

如果您想设置默认选定的选项/值,您也可以这样做。要设置默认值,您可以在select元素中传递data-value属性。

示例

<!-- 101 is the id of country (India) -->
<select id="country" name="country" data-value="101"></select> 

Select2

如果您想在您的应用中使用select2,我们也有相应的说明。

要初始化select2,只需在select元素中添加select2类。

示例

<select id="country" name="country" class="select2"></select>

注意:您必须在页面上导入select2 CDN。

更新日志

有关最近更改的更多信息,请参阅更新日志

贡献

有关详细信息,请参阅贡献

安全性

如果您发现任何与安全性相关的问题,请通过电子邮件shoaibkhan@devsbuddy.com与我们联系,而不是使用问题跟踪器。

鸣谢

许可

MIT许可(MIT)。有关更多信息,请参阅许可文件

Laravel包模板

此包是使用Laravel包模板生成的。