@kiva/kv-components 3.48.0 → 3.48.2

package/vue/KvWideLoanCard.vue

@@ -0,0 +1,429 @@
+<template>
+	<div
+		class="
+			tw-flex
+			tw-flex-row
+			tw-flex-wrap
+			tw-bg-white
+			tw-rounded
+			tw-w-full
+			tw-pb-1
+			tw-p-1
+			tw-gap-1
+			tw-items-center
+		"
+		:class="{'tw-pointer-events-none' : isLoading }"
+		style="box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);"
+	>
+		<div
+			class="loan-card-active-hover tw-flex-1 tw-min-w-[275px] md:tw-min-w-[320px] md:tw-max-w-[320px]"
+		>
+			<!-- Borrower image -->
+			<kv-loading-placeholder
+				v-if="isLoading"
+				class="tw-mb-1 tw-w-full tw-rounded"
+				:style="{ height: '15rem' }"
+			/>
+			<div
+				v-else
+				class="tw-relative tw-w-full"
+				@click="showLoanDetails"
+			>
+				<component
+					:is="tag"
+					:to="readMorePath"
+					:href="readMorePath"
+					class="tw-flex"
+					aria-label="Borrower image"
+					@click="clickReadMore('Photo')"
+				>
+					<kv-borrower-image
+						class="
+								tw-relative
+								tw-w-full
+								tw-bg-black
+								tw-rounded
+							"
+						:alt="`Photo of ${borrowerName}`"
+						:aspect-ratio="imageAspectRatio"
+						:default-image="{ width: imageDefaultWidth }"
+						:hash="imageHash"
+						:images="imageSizes"
+						:photo-path="photoPath"
+					/>
+
+					<div v-if="countryName">
+						<p
+							class="
+									tw-absolute
+									tw-bottom-1
+									tw-left-1
+									tw-text-primary
+									tw-bg-white
+									tw-rounded
+									tw-p-1
+									tw-mb-0
+									tw-mr-2
+									tw-text-h4
+									tw-inline-flex
+									tw-items-center"
+							style="padding: 2px 6px; text-transform: capitalize;"
+						>
+							<kv-material-icon
+								class="tw-h-2 tw-w-2"
+								:icon="mdiMapMarker"
+							/>
+							{{ formattedLocation }}
+						</p>
+					</div>
+				</component>
+				<kv-loan-bookmark
+					v-if="!isVisitor"
+					:loan-id="loanId"
+					:is-bookmarked="isBookmarked"
+					class="tw-absolute tw-right-1"
+					style="top: -6px;"
+					data-testid="loan-card-bookmark"
+					@toggle-bookmark="$emit('toggle-bookmark')"
+				/>
+			</div>
+		</div>
+
+		<div
+			class="tw-flex tw-flex-col tw-flex-1 tw-px-1"
+		>
+			<h3 class="tw-hidden md:tw-inline-block">
+				{{ borrowerName }}
+			</h3>
+			<!-- Loan tag -->
+			<component
+				:is="tag"
+				:to="readMorePath"
+				:href="readMorePath"
+				class="tw-flex hover:tw-no-underline focus:tw-no-underline"
+				aria-label="Loan tag"
+				@click="clickReadMore('Tag')"
+			>
+				<kv-loan-tag
+					v-if="showTags && !isLoading"
+					:loan="loan"
+					:kv-track-function="kvTrackFunction"
+				/>
+			</component>
+
+			<component
+				:is="tag"
+				:to="readMorePath"
+				:href="readMorePath"
+				class="loan-card-use tw-text-primary"
+				aria-label="Loan use"
+				@click="clickReadMore('Use')"
+			>
+				<!-- Loan use  -->
+				<div class="tw-pt-1">
+					<div
+						v-if="isLoading"
+						class="tw-w-full"
+						style="height: 5.5rem;"
+					>
+						<div
+							v-for="(_n, i) in [...Array(4)]"
+							:key="i"
+							class="tw-h-2 tw-mb-1"
+						>
+							<kv-loading-placeholder />
+						</div>
+					</div>
+					<div v-else>
+						<kv-loan-use
+							:use="loanUse"
+							:loan-amount="loanAmount"
+							:status="loanStatus"
+							:borrower-count="loanBorrowerCount"
+							:name="borrowerName"
+							:distribution-model="distributionModel"
+						/>
+					</div>
+				</div>
+			</component>
+			<!-- Loan call outs -->
+			<kv-loading-placeholder
+				v-if="isLoading || typeof loanCallouts === 'undefined'"
+				class="tw-mt-1.5 tw-mb-1"
+				:style="{ width: '60%', height: '1.75rem', 'border-radius': '500rem' }"
+			/>
+
+			<kv-loan-callouts
+				v-else
+				:callouts="loanCallouts"
+				class="loan-callouts tw-my-1.5"
+			/>
+
+			<div class="tw-flex tw-flex-row tw-justify-between tw-gap-1 md:tw-gap-3 ">
+				<!-- Fundraising -->
+				<div
+					v-if="!hasProgressData"
+					class="tw-w-full tw-pt-1 tw-pr-1"
+				>
+					<kv-loading-placeholder
+						class="tw-mb-0.5"
+						:style="{ width: '70%', height: '1.3rem' }"
+					/>
+
+					<kv-loading-placeholder
+						class="tw-rounded"
+						:style="{ width: '70%', height: '0.5rem' }"
+					/>
+				</div>
+				<component
+					:is="tag"
+					v-if="unreservedAmount > 0"
+					:to="readMorePath"
+					:href="readMorePath"
+					class="loan-card-progress tw-mt-1 tw-flex-grow"
+					aria-label="Loan progress"
+					@click="clickReadMore('Progress')"
+				>
+					<kv-loan-progress-group
+						id="loanProgress"
+						:money-left="`${unreservedAmount}`"
+						:progress-percent="fundraisingPercent"
+						class="tw-text-black"
+					/>
+				</component>
+
+				<!-- CTA Button -->
+				<kv-loading-placeholder
+					v-if="!allDataLoaded"
+					class="tw-rounded tw-self-start"
+					:style="{ width: '9rem', height: '3rem' }"
+				/>
+
+				<kv-lend-cta
+					v-else
+					:loan="loan"
+					:basket-items="basketItems"
+					:is-loading="isLoading"
+					:is-adding="isAdding"
+					:enable-five-dollars-notes="enableFiveDollarsNotes"
+					:five-dollars-selected="fiveDollarsSelected"
+					:kv-track-function="kvTrackFunction"
+					:show-view-loan="showViewLoan"
+					:custom-loan-details="customLoanDetails"
+					:external-links="externalLinks"
+					:route="route"
+					:user-balance="userBalance"
+					:get-cookie="getCookie"
+					:set-cookie="setCookie"
+					class="tw-mt-auto tw-self-end"
+					:class="{'tw-flex-grow' : unreservedAmount === 0, 'tw-flex-shrink-0' : unreservedAmount > 0}"
+					@add-to-basket="$emit('add-to-basket', $event)"
+					@show-loan-details="clickReadMore('ViewLoan')"
+				/>
+			</div>
+		</div>
+	</div>
+</template>
+
+<script>
+import { loanCardComputedProperties, loanCardMethods } from '../utils/loanCard';
+import KvLoanUse from './KvLoanUse.vue';
+import KvBorrowerImage from './KvBorrowerImage.vue';
+import KvLoanProgressGroup from './KvLoanProgressGroup.vue';
+import KvLoanCallouts from './KvLoanCallouts.vue';
+import KvLendCta from './KvLendCta.vue';
+import KvLoanBookmark from './KvLoanBookmark.vue';
+import KvLoanTag from './KvLoanTag.vue';
+import KvMaterialIcon from './KvMaterialIcon.vue';
+import KvLoadingPlaceholder from './KvLoadingPlaceholder.vue';
+
+export default {
+	name: 'KvWideLoanCard',
+	components: {
+		KvBorrowerImage,
+		KvLoadingPlaceholder,
+		KvLoanUse,
+		KvLoanProgressGroup,
+		KvMaterialIcon,
+		KvLendCta,
+		KvLoanTag,
+		KvLoanCallouts,
+		KvLoanBookmark,
+	},
+	props: {
+		loanId: {
+			type: Number,
+			default: undefined,
+		},
+		loan: {
+			type: Object,
+			default: null,
+		},
+		customLoanDetails: {
+			type: Boolean,
+			default: false,
+		},
+		showTags: {
+			type: Boolean,
+			default: false,
+		},
+		categoryPageName: {
+			type: String,
+			default: '',
+		},
+		enableFiveDollarsNotes: {
+			type: Boolean,
+			default: false,
+		},
+		isAdding: {
+			type: Boolean,
+			default: false,
+		},
+		isVisitor: {
+			type: Boolean,
+			default: true,
+		},
+		basketItems: {
+			type: Array,
+			default: () => ([]),
+		},
+		isBookmarked: {
+			type: Boolean,
+			default: false,
+		},
+		kvTrackFunction: {
+			type: Function,
+			required: true,
+		},
+		photoPath: {
+			type: String,
+			required: true,
+		},
+		showViewLoan: {
+			type: Boolean,
+			default: false,
+		},
+		externalLinks: {
+			type: Boolean,
+			default: false,
+		},
+		route: {
+			type: Object,
+			default: undefined,
+		},
+		userBalance: {
+			type: String,
+			default: undefined,
+		},
+		getCookie: {
+			type: Function,
+			default: undefined,
+		},
+		setCookie: {
+			type: Function,
+			default: undefined,
+		},
+		fiveDollarsSelected: {
+			type: Boolean,
+			default: false,
+		},
+		customCallouts: {
+			type: Array,
+			default: () => ([]),
+		},
+	},
+	setup(props) {
+		const {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+		} = loanCardComputedProperties(props);
+
+		const {
+			clickReadMore,
+			showLoanDetails,
+		} = loanCardMethods(props);
+
+		return {
+			allDataLoaded,
+			borrowerName,
+			city,
+			countryName,
+			distributionModel,
+			formattedLocation,
+			fundraisingPercent,
+			hasProgressData,
+			imageHash,
+			isLoading,
+			loanAmount,
+			loanBorrowerCount,
+			loanCallouts,
+			loanStatus,
+			loanUse,
+			mdiMapMarker,
+			readMorePath,
+			state,
+			tag,
+			unreservedAmount,
+			clickReadMore,
+			showLoanDetails,
+		};
+	},
+	computed: {
+		cardWidth() {
+			return '374px';
+		},
+		imageAspectRatio() {
+			return 1;
+		},
+		imageDefaultWidth() {
+			return 320;
+		},
+		imageSizes() {
+			return [
+				{ width: this.imageDefaultWidth, viewSize: 1024 },
+				{ width: this.imageDefaultWidth, viewSize: 768 },
+				{ width: 416, viewSize: 480 },
+				{ width: 374, viewSize: 414 },
+				{ width: 335, viewSize: 375 },
+			];
+		},
+	},
+};
+</script>
+
+<style lang="postcss" scoped>
+/** Shared with KvClassicLoanCard */
+.loan-card-use:hover,
+.loan-card-use:focus {
+	@apply tw-text-primary;
+}
+.loan-card-active-hover:hover .loan-card-use {
+	@apply tw-underline;
+}
+.loan-card-progress:hover,
+.loan-card-progress:focus {
+	@apply tw-no-underline;
+}
+/** Unique to this loan card */
+.loan-callouts >>> div{
+	@apply tw-flex-wrap tw-h-auto;
+}
+</style>

package/vue/stories/KvBorrowerImage.stories.js

@@ -60,3 +60,9 @@ const props = {
 };
 
 export const Default = story(props);
+
+export const Square = story({
+	...props,
+	aspectRatio: 1,
+	defaultImage: { width: 300 },
+});

package/vue/stories/KvClassicLoanCard.stories.js

@@ -28,6 +28,7 @@ const story = (args) => {
 					:kv-track-function="kvTrackFunction"
 					:photo-path="photoPath"
 					:show-view-loan="showViewLoan"
+					:custom-callouts="customCallouts"
 				/>
 			</div>
 		`,
@@ -118,6 +119,38 @@ export const ShowTags = story({
 	showTags: true,
 });
 
+export const CustomCallouts = story({
+	loanId: loan.id,
+	loan: {
+		...loan,
+		loanFundraisingInfo: {
+			fundedAmount: '950.00',
+			isExpiringSoon: false,
+			reservedAmount: '0.00',
+		},
+	},
+	kvTrackFunction,
+	photoPath,
+	showTags: true,
+	customCallouts: ['Loan Length: 15mo'],
+});
+
+export const CustomCalloutsWrap = story({
+	loanId: loan.id,
+	loan: {
+		...loan,
+		loanFundraisingInfo: {
+			fundedAmount: '950.00',
+			isExpiringSoon: false,
+			reservedAmount: '0.00',
+		},
+	},
+	kvTrackFunction,
+	photoPath,
+	showTags: true,
+	customCallouts: ['Loan Length: 15mo', 'Long Dairy Processing'],
+});
+
 export const Matched = story({
 	loanId: loan.id,
 	loan: {

package/vue/stories/KvLightbox.stories.js

@@ -2,6 +2,7 @@ import { mdiLightningBolt } from '@mdi/js';
 import KvLightbox from '../KvLightbox.vue';
 import KvMaterialIcon from '../KvMaterialIcon.vue';
 import KvButton from '../KvButton.vue';
+import KvToast from '../KvToast.vue';
 
 export default {
 	title: 'KvLightbox',
@@ -253,3 +254,51 @@ export const Informational = InformationalTemplate.bind({});
 Informational.args = {
 	title: 'Lightbox Title',
 };
+
+const ToastInLightboxTemplate = (args, {
+	argTypes,
+}) => ({
+	props: Object.keys(argTypes),
+	components: {
+		KvToast,
+		KvButton,
+		KvLightbox,
+	},
+	template: `
+		<div>
+			<kv-button @click="isLightboxVisible = true;">Show lightbox</kv-button>
+
+			<kv-lightbox
+				:visible="isLightboxVisible"
+				title="Toast in Lightbox"
+				@lightbox-closed="isLightboxVisible = false"
+			>
+				<p>Click the button below to show a toast.</p>
+				<template #controls>
+					<kv-button @click="showToast(message, type, persist)">Show Toast</kv-button>
+				</template>
+			</kv-lightbox>
+
+			<!-- div below is a kludge for storybook docs -->
+			<div class="tw-fixed tw-z-toast tw-inset-0 tw-pointer-events-none">
+				<div class="tw-fixed tw-left-0 tw-right-0 tw-top-2 tw-pointer-events-auto">
+					<kv-toast ref="toastRef" @close="onClose" />
+				</div>
+			</div>
+		</div>
+	`,
+	data() {
+		return {
+			isLightboxVisible: false,
+		};
+	},
+	methods: {
+		showToast(messageInput, type, persistInput) {
+			this.$refs.toastRef.show(messageInput, type, persistInput);
+		},
+		onClose() {
+		},
+	},
+});
+export const toastInLightbox = ToastInLightboxTemplate.bind({});
+toastInLightbox.args = { type: 'confirmation', message: 'This is a toast in a lightbox.' };